home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / fido / crystalfix.lha / Upgrade.readme < prev   
Text File  |  1994-07-07  |  6KB  |  188 lines
  1. The upgrade from 1.2 to 2.0 adds the following features and fixes:
  2.  
  3.  * GCF-compatible keywords make CrystalFix easier to set up and more
  4.    compliant with TrapToss.  CrystalFix has its own section now.
  5.  
  6.  * FTick support.
  7.  
  8.  * Totally new GROUP system is a lot easier to understand and explain
  9.    and is also much more readable, yet is functionally equivalent.  You
  10.    assign single letters to each group, instead of powers-of-two.
  11.    Better yet, since I'm free of ARexx's bitand() function, I'm free
  12.    of the many bugs it seems to have.  This should FINALLY lick the
  13.    security problem bugs that have haunted me despite repeated fixes.
  14.  
  15.  * COUNT command controls what counts, if any, are shown to the user
  16.    at the end of queries, and can be used to greatly speed up
  17.    CrystalFix's startup if you have hosts with big NA files.
  18.  
  19.  * Made sure the archive has the right versions of everything this time!
  20.    Reply linking should work thoroughly.
  21.  
  22.  * Rescan now should not produce dupes to points in an area, because,
  23.    instead of relying only on SEEN-BYs, it actually only rescans for the
  24.    given node, by creating a temporary config file, scanning, then
  25.    deleting the temp file.
  26.  
  27.  * Fixed a few bugs, such as the doubled MAIN lines, some security
  28.    problems attaching to host areas, problems if you kept your config
  29.    file on a different partition than Mail: (or if you don't have a
  30.    Mail: assign), conflicts with the LOGFILE and LOGLEVEL options in
  31.    other areas like TrapSched, and more.
  32.  
  33.  * LOGFILE command to let CrystalFix have its own private log.
  34.  
  35.  * Backups and working file copies of the config file are stored in the
  36.    same place as the original, with a suffix added.
  37.  
  38.  * Control over location of CrystalFix.help
  39.  
  40. The upgrade from 1.2 to 2.0 requires some significant, but not at all
  41. difficult, modifications to your config file.  Here's a step-by-step
  42. guide to them.  After this, we'll be GCF-compliant from now on, so
  43. there should be no need for more changes, even with new TrapToss
  44. versions.  In the following, you'll see a lot of sample lines and their
  45. conversions; that is, I've used real data instead of <variables>
  46. because I thought it would be easier to read.  It should be self-evident
  47. how to apply these to your own config file.
  48.  
  49. 1. Add the following line to create a new section.  The best place to
  50.    put this is right after (or at least somewhere after) the TrapToss
  51.    section.
  52.  
  53.    [CrystalFix]
  54.  
  55. 2. Convert the line
  56.  
  57.    ;!FIX SYSOP Sysop Name
  58.  
  59.    into
  60.  
  61.    SYSOP "Sysop Name"
  62.  
  63.    (that is, take off the ;!FIX and add quotes.)  Move this to the global
  64.    section of your file.  (Or put it in the TrapToss or CrystalFix sections
  65.    if you prefer.)
  66.  
  67. 3. Convert the line
  68.  
  69.    ;!FIX LOGLEVEL 5
  70.  
  71.    into
  72.  
  73.    LOGLEVEL 5
  74.  
  75.    and move it into the CrystalFix section.
  76.  
  77. 4. Convert the line
  78.  
  79.    ;!FIX NEWPATH Mail:echos
  80.  
  81.    into
  82.  
  83.    NEWPATH "Mail:echos"
  84.  
  85.    and move it into the CrystalFix section.
  86.  
  87. 5. The bits system has been completely replaced with a functionally
  88.    equivalent, but easier to explain and understand and document,
  89.    groups system.  Every power-of-two is replaced with a single letter,
  90.    and addition is replaced with concatenation.  In the new system,
  91.    areas, hosts, and systems are allowed to "own" one or more group
  92.    letters (you decide which letter means which area), and a system can
  93.    only access an area if it owns all the letters (if any) that that area
  94.    owns.  See the new SampleFido.cfg file for an example or two.  If
  95.    you need more explanation, read step 6 and 7 from the CrystalFix.doc
  96.    file.
  97.  
  98.    Then convert your bitmasks into group letters.  Plan this out and
  99.    change your comments appropriately.  For instance, the bitmask 2
  100.    might become the letter F, and the bitmask 4 might become T.  When
  101.    you would have added the bitmasks to get 6, just concatenate (in
  102.    any order) the letters (as in FT).
  103.  
  104. 6. Convert the line
  105.  
  106.    ;!FIX SYSTEM 1:325/611.1 PASSWORD 10 6
  107.  
  108.    into
  109.  
  110.    SYSTEM 1:325/611.1 PASSWORD 10 "FT"
  111.  
  112.    where FT is the concatenation of the groups that correspond to the
  113.    bitmasks that formed the bitmask 6.  Move this line into the CrystalFix
  114.    section.
  115.  
  116. 7. Convert the line
  117.  
  118.    ;!FIX HOST 1:325/611.0 1:141/1130.0 PASSWORD 10 6 Mail:Fidonet.NA
  119.  
  120.    into
  121.  
  122.    HOST 1:325/611.0 1:141/1130.0 PASSWORD 10 "FT" "Mail:Fidonet.NA"
  123.  
  124.    Notice the quotes around the pathname.  Move this into the CrystalFix
  125.    section.
  126.  
  127. 8. Convert the line
  128.  
  129.    ;!FIX LEVEL 10 2 A really fun area you should attach to
  130.  
  131.    into
  132.  
  133.    LEVEL 10
  134.    GROUP "F"
  135.    DESCRIPTION "A really fun area you should attach to"
  136.  
  137.    Note the quotes and the fact that it's three separate lines now.
  138.  
  139. 9. If you want CrystalFix to use a different log file, add the following
  140.    line to your CrystalFix section:
  141.  
  142.    LOGFILE "Mail:CrystalFix.log"
  143.  
  144.    except use your own log file name.
  145.  
  146. 10.If you want to control the location and filename of CrystalFix.help
  147.    add the following line to your CrystalFix section:
  148.  
  149.    HELPFILE "Mail:texts/CrystalFix.help"
  150.  
  151.    except use your own help file pathname.
  152.  
  153.  
  154. 11.If you have some hosts with big NA files and you want to save some
  155.    time in CrystalFix startup, or if you want to not show the user quite
  156.    as much info at the end of queries, add one of the following lines
  157.    before the first HOST line (if any) of your CrystalFix section:
  158.  
  159.    COUNT NONE
  160.    COUNT ATTACH
  161.    COUNT AVAIL
  162.  
  163.    See step 13 in the docs for more info.
  164.  
  165. 12.Remove the IGNORESENT line from Fido.cfg that you added for v1.(0|1|2).
  166.    Unless you like it.
  167.  
  168. 13.If you want to use FTick support, edit your Tick.cfg file and add
  169.    LEVEL, GROUP, and DESCRIPTION keywords under your AREA/FILEECHO
  170.    blocks.  You also need to add FLAGS keywords.  All Tick keywords must,
  171.    for the time being, be preceded by ";!".  See the docs for details
  172.    on these; but they all work just like the Fido.cfg equivalents.
  173.  
  174. 14.If you are supporting FTick and your Tick config is not Mail:tick.cfg
  175.    add its pathname to the end of your CrystalFix command line.  If the
  176.    Fido config pathname isn't already there, because you use the default
  177.    Mail:fido.cfg, you must put Mail:fido.cfg in first.
  178.  
  179. 15.If you use host autoforwarding, look at the ADDAREACMD command.
  180.  
  181. Rereading the docs might be nice, but is certainly not necessary.
  182. The new SampleFido.cfg file would be a bit more useful to read.
  183. See also the new SampleTick.cfg.  The whole process should be pretty simple.
  184.  
  185.  
  186. - Frank
  187.  
  188.